home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware Overload Trio 2
/
Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO
/
dir35
/
attic201.zip
/
ATTIC.HLP
< prev
next >
Wrap
Text File
|
1989-05-16
|
20KB
|
839 lines
~322
Documents to compare are either retrieved from the library or from
a disk file.
If LOCation is "L" enter the name of a library text file.
If LOCation is "D" enter a disk filename.
Enter <F9> to enter SELECT option to view text names.
Enter <esc> to backup.
`
~1
Enter in the pathname of the file(s) that you wish to add the library.
The file(s) will be added to the library if either of the following
conditions are met.
1) If no prior versions of the file exits in the library.
2) The last modification date on the file is more recent than
the latest version in the library.
The (?) and (*) wild card characters are supported in filenames and
extensions. The (?) means that any character can occupy that position
in a filename. The (*) means that any character can occupy that position
OR any of the remaining positions in the filename.
Example:
*.doc - processes all files in the current directory with a doc ext.
a*.doc - processes all files in the current directory starting with
the letter a and with a .doc ext.
?.* - processes all one character files in current directory.
`
~2
A one line comment can be stored with each version of a text that
is added to the library.
When processing multiple files with wild cards, a single comment can
be entered which is then stored with each Text added in that batch,
you can be prompted individually for comments for each Text as it is
added, or comment processing can be skipped for all file in the batch.
Enter S:
To be prompted for a single comment which will be applied to
all Texts added.
Enter D:
To be prompted for different comments for each Text.
Enter N:
To skip comment processing.
`
~200
The ADD function prompts for disk file pathname(s) and adds them to
the library. Only files whose modification date is greater than
the corresponding text library version date are added.
To add files to the library unconditionally use the FORCE option in
the Utility menu.
The use of <*> and <?> wild cards in pathnames is supported.
`
~201
The SELECT function is used to define a current text selection.
This selection can then be used in the Xtract, Keyword, Report
and Deletion functions to process groups of texts.
Text selection is made by first moving the cursor to highlight the
desired text and pressing the <+> key. Pressing the <-> key
unselects the highlighted text. Pressing <F1> selects all texts,
pressing <F2> unselects all texts and <F3> toggles all selections.
Typing the name of text jumps the cursor to that text. The arrow keys,
page_up and page_down move the cursor.
Optionally, the SELECT function can be used to scroll through a
library text on the screen by pressing <F4>.
`
~202
The KEYWORD function is used to maintain the association between
keywords and library texts. Keywords can be used in the Extract,
Delete and Report options to perform processing on groups of texts.
Keywords can be associated with a specific version or with the
latest version of a text. This latter type of keyword association
floats to the latest version of a text as new versions are added.
To Add or Delete Keywords:
1) Define a current selection of texts using the SELECT option.
2) Select one of the following version modes using the
VERSION option:
a) Last - maintains floating (latest version) keywords.
b) All - maintains keywords associated with any version.
c) Current - maintains keywords of latest version.
d) Specific - maintains keywords for specific versions.
3) Delete or Add Keywords.
!NOTE: KEYWORD maintenance is performed only on selected texts
and their versions defined by the VERSION setting.
`
~203
XTRACT retrieves text versions from a library and writes them to files
on disk.
The text versions to be extracted can be identified by one of the
following means:
a) Current SELECTion and VERSION mode.
b) KEYWORD
c) A specified text and version.
Full pathnames and wildcards <*> and <#> for output files are
supported. The wild card <*> when used in place of a filename
or extension denotes the respective text name or text extension.
The wild card <#> when used in place of an extension is replaced
by the version number of the text being extracted. This allows
extraction of multiple versions of a text using one command.
`
~204
ATTIC provides the following two reports:
1) HISTORY REPORT
Displays version create date, library update date and
comments for all versions of selected texts. The text
selection for the report is based upon a current
SELECTion, a defined Keyword or specified text.
2) KEYWORD REPORT
Displays listing of keywords and their associated
texts and/or versions. Floating keywords are
associated with version number <last>
for their respective texts.
The report can be sorted by keyword or text.
Report output from either the HISTORY or KEYWORD reports can be
directed to a screen or to an output file.
`
~205
VERSION defines which versions of SELECTed texts are processed by
the KEYWORD and XTRACT options. The VERSION mode can be set to one
of the following four values:
Last - Denotes that the latest version, is to be processed.
Keywords defined with this mode set are not associated
with specific versions. Rather they "float" and
associate with the latest text at any point in time.
Current - Keywords are associated with the latest version.
In contrast to "Last", if later versions are added, the
keyword association does not "float" to the higher versions.
All - All versions are selected. Used with KEYWORD and
XTRACT options.
Specific - A single version number is selected. Allows keywords
to be associated with specific versions.
`
~206
COMPARE compares two files or texts and displays their differences
highlighted on the screen.
The objects to be compared can reside either in the library or on
disk.
When defining the objects to be compared you must specify whether
their location is either in the <L>ibrary or on <D>isk. For library
texts the version number and textname is entered. For disk files
the appropriate pathname is entered.
`
~207
The Utility menu provides access to the following three options:
1. FORCE
Unconditionally adds files to the library regardless of
their date of last modification. This is in contrast,
to the ADD option in the main menu which adds a file to the
library only if its modification date is greater than the
modification date of the latest version.
2. DELETE
Deletes Texts or the current Library. Text deletion can
be specified by current selection, specific text, or keyword.
3. Reorganize
Recovers space in library files caused by deletions.
`
~208
Returns to main menu.
`
~212
Setting the Version mode to LAST causes the Keyword Option to
create or delete "floating" keywords which always associate with
the latest version of a text. Keywords defined in this manner
do not need to be redefined as newer versions of a text are added to
the library. They always point to the "latest" version.
Keywords defined with this mode appear on Keyword reports as being
associated with the version number "last" as opposed to any specific
version number.
These keywords can be deleted only if the Version mode is set to LAST.
`
~213
Setting the Version mode to ALL has the following effects on
subsequent processing:
1) Any keywords added are associated with all versions of the
selected texts.
2) Keywords associated with any version number of the selected
texts are deleted by KEYWORD delete. This mode will not allow
deletion of "floating" keywords which always relate
to the latest version of a text.
3) Extracting library texts to disks under the current selection
option of the XTRACT function will process all versions.
(Be sure to use the <*> and/or <#> wildcards in defining the
output filename to avoid attempting to overwrite the same disk
file with multiple versions of the same text.)
`
~214
Setting the Version mode to CURRENT always selects the latest
version number when processing SELECTED texts in the XTRACT or
KEYWORD maintenance functions.
Under the CURRENT Version mode any keyword additions are
assigned to the latest version of the selected texts. As later
versions are added the associations of these keywords
DO NOT "float" to the later versions. This is in contrast
to the LAST Version mode.
`
~215
The SPECIFIC Version mode prompts for and sets the Version Mode
to a single version number.
The primary function of this mode is to facilitate the assignment
of keywords to prior versions of texts.
`
~216
Return to Main Menu.
'
~217
The KEYWORD report displays keywords and their
associated library texts and/or versions.
Version number <last> denotes floating keyword.
The report can be sorted by keyword or text.
Report output can be directed to the screen or an output file.
`
~218
The HISTORY report displays file create date,
library update date and comments.
Text selection for the report is based upon a
Current Selection, an entered Keyword or a specified
text.
Report output can be directed to the screen or an
output file.
`
~219
Return to main menu
`
~301
Enter in a pathname, without extension, for an existing library or
for a library that you wish to create.
The filename can be no more than 7 characters. The file
extension if entered is ignored.
<esc> exits the program and returns to MSDOS.
`
~302
The library you entered above cannot be found.
Enter <Y> to create a new library with this name.
Enter <N> to re-prompt for the name of a library.
Enter <esc> to return to MSDOS.
An ATTIC library consists of the following set of 5 files,
where xxxxxxx is the entered library name.
xxxxxxT.ATK - Contains text specific information.
xxxxxxV.ATK - Contains version specific information.
xxxxxxS.ATK - Contains segment specific information.
xxxxxxL.ATK - Contains texts.
xxxxxxK.ATK - Contains keywords.
`
~50
The HISTORY report can include all Currently selected texts, texts
assigned to a Keyword or a specific Text.
Enter <C> to report on currently selected texts.
Enter <K> to report on texts associated with a given keyword.
Enter <T> to report on a specific text.
Enter <esc> to exit function.
`
~50
Enter the name of the text on which you wish to report.
Enter <esc> to backup.
`
~52
Enter in a keyword to select texts on which to report.
Enter <esc> to backup.
`
~905
The SELECT option selects text(s) for the purpose of adding
keywords, extracting to disk, and history reporting.
Enter <esc> to complete selections and exit function.
Enter <+> to select text.
Enter <-> to unselect text
Enter <F1> to select all texts.
Enter <F2> to unselect all texts.
Enter <F3> to toggle text selections.
Enter <F4> to display highlighted text.
Enter <right arrow>, <left arrow>, <pgup>, <pgdn>, <down arrow> or
<up arrow> to move cursor.
`
~206
Enter version number of text to display.
<cr> selects latest version.
<esc> backs up.
`
~21
Texts can be selected for extraction to disk on the basis
of the current SELECTion, Keyword, or a specific Text.
Enter <C> to extract currently selected texts.
Enter <K> to extract based upon a defined keyword.
Enter <T> to extract a specific text.
Enter <esc> to exit function.
`
~22
The file to be extracted already exists on disk.
Enter <Y> to overwrite the existing file.
Enter <N> to skip the extraction of that file.
Enter <esc> to skip the extraction of the file and
exit function.
! note:
When extracting on the basis of a current selection
with a Version setting of ALL, or extracting with a
keyword associated with multiple versions of a text,
using the <#> wild card as an extension will
create multiple versions on disk using the version
number as an extension.
'
~23
Enter the name of the text to extract to disk.
Enter <esc> to backup.
`
~24
Enter the version number of the text to
extract.
Enter <cr> to select latest version.
Enter <esc> to backup.
`
~26
Enter a keyword which has been associated with one
or more texts. These texts will then be extracted
to disk.
Enter <esc> to backup.
`
~28
The Version Mode is set to ALL. The default output file
name is the textname with a version number extension.
Enter <cr> to accept the default.
Enter another path and/or filename.
Enter <esc> to backup.
Note!
When extracting multiple files at a time it is recommended
the wildcards <*> and/or <#> be used to avoid attempted
file overwrites on disk.
The <*> is replaced by the textname and/or extension.
The <#> when entered as an extension is replaced by the
text's version number.
'
~29
The default extracted filename is the textname and its extension
as denoted by the *.* wild card.
Enter <cr> to accept the default.
Enter another path and/or filename and extension.
Enter <esc> to backup.
Note!
When extracting multiple files at a time it is recommended
the wildcards <*> and/or <#> be used to avoid attempted
file overwrites on disk.
The <*> is replaced by the text name and/or extension.
The <#> when entered as an extension is replaced by the
text's version number.
`
~60
Enter <L> to delete the current library. This will delete the
ENTIRE LIBRARY you have open, including all of its texts.
The process will then exit to the system. Be careful
with this option; it deletes ALL TEXTS.
Enter <C> to delete currently selected Texts. This process will
delete all selected texts regardless of the Version Mode
setting.
Enter <T> to delete a specific text. You will then be prompted for
the name of the text to delete.
Enter <esc> to abort any deletes, and exit the function.
`
~62
Enter <Y> to confirm that you wish to delete the current
library and all of its texts. This is your last
chance.
Enter <esc> or <N> to abort delete.
`
'4
Enter a comment to be stored with all texts that will be added.
Enter <cr> to skip the comment.
Enter <esc> to backup.
`
~7
Enter a keyword to be associated with the selected texts.
The keyword can be up to 23 characters long.
Enter <esc> to exit.
`
~10
Enter a beginning range of keywords to delete.
Enter <cr> to select the first keyword for SELECTed
texts.
Enter <esc> to exit function.
`
~11
Enter the ending range of keywords.
If no beginning range was entered an entry of
<cr> sets the ending range to the last keyword in the
file.
If a beginning range was entered an entry of <cr> makes the
beginning and ending range the same to facilitate the deletion
of a specific keyword.
Enter <esc> to backup.
`
~12
Enter <Y> to confirm delete.
Remember the keywords selected for deletion is a function of:
1) the range of keywords entered.
2) the texts currently selected.
3) the version mode.
Enter <esc> to backup.
`
~6
Enter a comment to be stored with the text.
Enter <cr> to skip comment entry.
Enter <esc> to abort file add.
`
~101
Enter <D> to select file for compare from disk file.
Enter <L> to select file for compare from library text.
Enter <esc> to backup.
`
~102
Enter version number of library file to compare.
Enter <cr> to select latest version of library file.
Enter <esc> to exit.
`
~30
The keyword report can be sorted by keyword or text name.
Enter <K> to sort by keyword.
Enter <T> to sort by text.
Enter <esc> to exit function.
`
~31
Enter beginning range of texts to include in the report.
Enter <cr> to select first text.
Enter <esc> to exit.
`
~32
Enter the ending range of texts to select.
If a beginning range was entered the ending range defaults to
the beginning range to facilitate report generation for a specific
text.
If a beginning range was not entered the ending range defaults to
the last text in the library.
Enter <cr> to select default.
Enter <esc> to exit.
`
~33
Enter beginning range of keywords to include in the report.
Enter <cr> to select first keyword.
Enter <esc> to exit.
`
~34
Enter the ending range of keywords to include in report.
If a beginning range was entered the ending range defaults to
the beginning range to facilitate report generation for a specific
keyword.
If a beginning range was not entered the ending range defaults to
the last keyword in the library.
Enter <cr> to select default.
Enter <esc> to exit.
`
~40
Enter <Y> or <cr> to send output to the screen.
Enter <N> to send output to a disk file.
Enter <esc> to backup.
`
~41
Enter <cr> to select default output filename.
Enter in output filename.
Enter <esc> to backup.
`
~220
Add keywords for selected texts
`
~221
Delete Keywords for selected texts
`
~222
Exit
`
~223
Force adds files to the library regardless of their date of
last modification. In comparison, the Add option in the main
menu adds a file to the library only if its modification date
is greater than the modification date of the latest version
of the respective text in the library.
`
~224
Deletes texts or the current library.
Text deletion can be specified by current
selection, specific text, or keyword.
`
~225
Reorganize recovers space in library files caused
by text deletions.
`
~226
return to main menu
`
~401
Enter in the pathname of the file(s) that you wish to add the library.
The file(s) will be unconditionally added to the library.
The (?) and (*) wild card characters are supported in filenames and
extensions. The (?) means that any character can occupy that position
in a filename. The (*) means that any character can occupy that position
OR any of the remaining positions in the filename.
Example:
*.doc - processes all files in the current directory with a doc ext.
a*.doc - processes all files in the current directory starting with
the letter a and with a .doc ext.
?.* - processes all one character files in current directory.
`